home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / convrtrs / cmap111.lha / CMAP111.README < prev   
Encoding:
Text File  |  1992-09-02  |  2.7 KB  |  56 lines
  1. Short: WARLOCK's IFFCMAP converter (just AGA)
  2. Dir: os30/util
  3. Uploader: toni.rutar@uni-mb.si
  4.  
  5.                         USER MANUALS FOR CMAP-ASM
  6.  
  7.   Feel bored when no IFF Converter converts colours right for your ASM AGA
  8. coding?? If so, just take this program, use it, trash it and if you think it
  9. is good, pay me about 20DM in whatever currency to encurage me for writting
  10. newer,bigger, better, faster version.
  11.   It is just for AGA machines and wants Kick3.0 and above. If you can't
  12. afford that, leave it be. It supports just IFF CMAP chunks, so JPEG, GIF and
  13. other sh*t may go to.... :)  You can choose 2 different convertations:
  14. one for using LoadRGB32() call and one for hitting hardware directly with
  15. Copper. Do a "?" option when running CMap and it will display a little help,
  16. which i won't mention here.
  17.   Before yelling at me, it doesn't work, I should say it will not write an
  18. ASCII string, just a binary file, so other than ASM programmers can use it,
  19. too. Using ASM u should type INCBIN "converted file name" at any position
  20. in CopperList. Users of system must do first two words which describe how
  21. many colours must be used and at what colour register must "colouring" begin.
  22. The reason it is not added is that you can easily do great effects by not
  23. giving that: DC.B 1st colur, DC.W lenght  as it is written in CMAP chunk.
  24. This is not supported in Copper mode, coz it is impossible to do. Beware of
  25. BPLCON3 register which is not set to zero at the end. I didn't do that, coz
  26. you might not needed value zero, so Copper would do 2 moves to BPLCON3, which
  27. is rather odd.
  28.   If someone doesn't follow that, here is a little example what to do with
  29. converted file:
  30. - if you use system
  31. LoadRGB32:
  32.         dc.w    colour1, lenght
  33.         incbin  "converted file name"
  34. - if you hate system:
  35. copper:
  36.         incbin  "converted file name"
  37.         cmove   whatever,whatever
  38.                  .
  39.                  .
  40.                  .
  41.         cend
  42.   A tip for Copper users: as Copper is slower when using a lot of bitplanes,
  43. first set display like using just one bitplane then INCBIN and then proper
  44. bitplane display. Very usefull for 256 colour mode, when Copper must do more
  45. than 500 instructions just for setting colours.
  46.   Any bug or other reports email to toni.rutar@uni-mb.si (add subject "for
  47. Bulb") or IRC to Bulb. :)
  48.   By the way, if you are "multitasker" don't be scared when you will have to
  49. convert colours from huge picture. No matter what size the picture is, CMap
  50. will always use about 5Kb of memory. Done for the dudes like me. :)
  51.   History:
  52. V1.00 First working version.
  53. V1.01 Just optimisations.
  54. V1.10 Added -s option + option using, coz first version had only one option.
  55. V1.11 Now deletes part of file which was written if "Volume is full" occours.
  56.